home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / 3d_tools / objector.lha / objector10 / objector10demo.doc < prev    next >
Encoding:
Text File  |  1994-03-08  |  11.2 KB  |  290 lines
  1. PRODUCT:
  2.  
  3.    Objector v1.0 DEMO (SHAREWARE)                                         March 1st 1994
  4.  
  5. PURPOSE:
  6.  
  7.    The main feature of this program is that it is able to merge faces and lines within an object.  
  8.    This means you can reduce triangulation in objects and so reducing the number of polygons
  9.    in the object! In this way, you can import Imagine objects into Lightwave in a very efficient
  10.    way for faster rendering!
  11.    The program supports loading of objects in IMAGINE TTDDD format and VIDEOSCAPE format.
  12.    The program supports saving of objects in AutoCAD DXF format, saving group-objects in 
  13.    separate layers, and also VIDEOSCAPE format (for loading in LightWave).
  14.    So apart from being able to merge faces and lines it is also an object converter.
  15.    The program includes a double buffered 3D display routine wich shows the object converted. 
  16.  
  17.    Note: The TTDDD Imagine object format is generated by an external command called
  18.          READWRITE. This command is part of the T3DLIB distribution written by Glenn M. Lewis.
  19.          The E-mail address of Glenn M. Lewis is GLEWIS@PCOCD2.INTEL.COM
  20.          READWRITE converts a binary imagine file to an ASCII imagine file, it can also convert 
  21.          this resulting ASCII file back to the binary format. 
  22.          The archive wich holds this distribution is called T3DLIB??.lha.
  23.  
  24. DEMO:
  25.  
  26.    The only limitation of the demo version is the maximum number of points used in the loaded
  27.    objects. This maximum is 100 points!
  28.  
  29. AUTHOR:
  30.  
  31.    Toine Beunes
  32.    Groenewegenstr. 42 
  33.    2614 BG DELFT
  34.    HOLLAND
  35.  
  36.    phone. (voice) (0)15-121975
  37.           (BBS)   (0)15-157954 TADD line 1
  38.           (BBS)   (0)15-144825 TADD line 2
  39.  
  40.  
  41.    E-mail address. STRUIJK@DUTIWS.TWI.TUDELFT.NL
  42.   
  43.    NOTE:  This E-mail address is from a friend of mine, so make sure you mention my name 
  44.           and the purpose of the message, so eventually you get the right response from 
  45.           the right guy!
  46.  
  47. REGISTRATION:
  48.  
  49.    Registration to this program can be done by sending 25$ US in an envelope to the
  50.    address mentioned at the start of the program. This address should be the same as the one 
  51.    mentioned above! Don't forget to mention your NAME, ADDRESS, PHONE. 
  52.    After I receive your letter I will send a floppy to that address containing the program 
  53.    without DEMO-protection plus the C-source code of the entire program (mostly ANSI). 
  54.    You may use the source for all non-commercial personal purposes. 
  55.    If you deside to use the source code or a part from it in a commercial product you need 
  56.    a written permit from me in person. 
  57.  
  58. DISTRIBUTION:
  59.  
  60.    This program may only be distributed in the original archive OBJECTOR10DEMO.lha,
  61.    wich holds:
  62.  
  63.       Objector10demo      
  64.       Objector10demo.Doc  
  65.       + some test objects
  66.  
  67. DAMAGE CLAIME:
  68.  
  69.    The author of this program holds NO reponsibility for ANY damages due to the
  70.    use of this program. With other words 'use it at your own risk'.
  71.  
  72. FUTURE DEVELOPMENTS:
  73.  
  74.    - an option to triangulate the objects (from Imagine to Imagine object opti-
  75.      malisation)  
  76.    - full support of T3DLIB (direct loading and saving of binary Imagine objects)
  77.    - graphical interface
  78.  
  79. -------------------------------------------------------------------------------
  80. USER GUIDE Objector V1.0 March 1st 1994
  81. -------------------------------------------------------------------------------
  82.  
  83. SHORT TUTORIAL:
  84.  
  85.    Imagine:
  86.  
  87.       start imagine.
  88.       select the detail editor.
  89.       load object.
  90.       save object (say: test.iob).
  91.  
  92.    T3DLIb:
  93.  
  94.       readwrite test.iob test.t3d
  95.  
  96.    Objector:
  97.  
  98.       start Objector10
  99.       type 'LOADT3D test.t3d'
  100.       type MERGE -F-L
  101.       type 'SAVEVS test.vs'
  102.       type 'QUIT'
  103.  
  104. COMMANDS:
  105.  
  106.    Loading:
  107.  
  108.       LOADT3D [<filename>]
  109.  
  110.          loads Imagine object in TTDDD format.
  111.  
  112.          if you omit the filename a file requester will appear, wich has a
  113.          standard assign to RAM:
  114.  
  115.          The TTDDD Imagine object format is generated by an external command called READWRITE. 
  116.          This command is part of the T3DLIb distribution written by Glenn M. Lewis.
  117.          The E-mail address of Glenn M. Lewis is GLEWIS@PCOCD2.INTEL.COM
  118.  
  119.          READWRITE converts a binary imagine file to an ASCII imagine file, it can also convert 
  120.          this resulting ASCII file back to the binary format. 
  121.          The archive wich holds this distribution is called T3DLib39.lha.
  122.  
  123.       LOADVS  [<filename>]
  124.  
  125.          loads Videoscape object.
  126.  
  127.          if you omit the filename a file requester will appear, wich has a
  128.          standard assign to RAM:
  129.  
  130.    Merging:
  131.  
  132.       MERGE [-f][-fl][-l][-o]
  133.  
  134.          this command starts the merging process.
  135.          
  136.             give [-f] if you want merging of the faces.
  137.                  [-l] if you want merging of all lines.
  138.                  [-o] if you want merging of lonely lines (lines wich are not used in faces)
  139.                  [-fl] if you want to merge lines and faces at the same time.
  140.                        This option is only usefull if MAXEDGES is set
  141.  
  142.             example:
  143.          
  144.                 MERGE -f   ;merges the faces 
  145.                 MERGE -f-l ;after merging the faces it merges the lines
  146.              
  147.          four commands affect the result after the merging process namely the commands:
  148.             MAXEDGES, 
  149.             HIDEFACE,
  150.             FACEANGLE and 
  151.             EDGEANGLE.
  152.  
  153.  
  154.    Contol over the merging process:
  155.  
  156.       MAXEDGES <number>
  157.          
  158.          This command defines the maximum number of edges in a polygon. This is necessary
  159.          to get an object for DXF format, this format allows a maximum of 4 edges in a polygon.
  160.          It can also be used to get a grid-effect after merging an extruded faces.
  161.         
  162.          The algorithm tests the number of edges in the resulting polygon after each merge 
  163.          of two polygons. If the resulting merged polygon has to many edges 
  164.          (greater than MAXEDGES) these polygons are NOT merged.
  165.    
  166.          The algorithm does NOT check, if a resulting merged polygon that has to many edges,
  167.          can be merges with other polygons hereby creating a polygon that does complie with 
  168.          the maximum number of edges. This is too time-consuming and needs a different algorithm! 
  169.          
  170.          However to optimize a bit, there is the posibility to merge the lines in a 
  171.          resulting polygon after each merge of two faces. Thus reducing the number of edges 
  172.          in the resulting polygon. This can result in further possibilities to merge!
  173.          This is the -fl option in the MERGE command.
  174.  
  175.          If you don't use MAXEDGES (number set to -1) the use of the -fl option is a slow way 
  176.          to obtain the same result as the -f-l options combined. So in this case the -f-l option
  177.          should be used. 
  178.          
  179.          to disable any maximum of edges in a polygon type: MAXEDGES -1
  180.  
  181.       HIDEFACE ON|OFF
  182.  
  183.          Creates a backface polygon for every merged polygon. Default=ON
  184.  
  185.          It is allmost allways necessary to create a backface for every polygon in the object
  186.          because otherwise the polygons are only visible from one side (most 3D display 
  187.          routines only draw polygons that face the viewpoint).
  188.  
  189.          Test this option with a cylinder and you will understand the meaning of this.
  190.          A sphere could be converted with backface OFF, but only if the viewpoint stays 
  191.          OUTSIDE the sphere.
  192.  
  193.       FACEANGLE <angle>
  194.  
  195.          This is the maximum angle between two polygons at wich merging will take
  196.          place. You should make sure that the merged polygons (triangles) are
  197.          indeed in the same face! Default=0.3 degrees
  198.          - setting this angle to big will result in faces being merged that are 
  199.            NOT in the same face. 
  200.          - setting this angle to small will result in NO merging.
  201.  
  202.      note:
  203.  
  204.          The merging algorithm does the following; looks if two edges in two
  205.          polygons are the same, if so determines the angle between the polygons, if the
  206.          angle is smaller than or equal to FACEANGLE then merges the two polygons to a 
  207.          new polygon. hereafter this polygon gets checked with all other polygons......
  208.  
  209.      trick:
  210.  
  211.          If you have two polygons wich are in the same plane and beside eachother,
  212.          but you don't want them merged, you have to make sure that they have NO common
  213.          edges (don't merge the points in imagine).
  214.  
  215.       EDGEANGLE <angle>
  216.  
  217.          This is the maximum angle between two lines at wich merging will take
  218.          place. You should make sure that the merged lines (edges) indeed point 
  219.          in the same direction! Default=0.3 degrees
  220.          - setting this angle to big will result in lines being merged that are 
  221.            NOT pointing in the same direction. 
  222.          - setting this angle to small will result in NO merging.
  223.  
  224.    Saving:
  225.  
  226.       SAVEDXF [-f][-l][-p][-lo][-po] [<filename>]
  227.  
  228.          give [-f] to save the faces
  229.               [-l] to save all lines
  230.               [-p] to save all points
  231.               [-lo] to save the lonely lines  (lines not used in faces)
  232.               [-po] to save the lonely points (points not used in faces or lines)
  233.          
  234.          Saves the converted object in DXF format (used by Auto Cad).
  235.      Each object in a group will be saved to a different layer.
  236.          If you ommit the filename a file requester will appear, wich has a
  237.          standard assign to RAM:
  238.  
  239.  
  240.       SAVEVS [-f][-lo][-po][<filename>]
  241.  
  242.          give [-f] to save the faces
  243.               [-lo] to save the lonely lines  (lines not used in faces)
  244.               [-po] to save the lonely points (points not used in faces or lines)
  245.  
  246.          Saves the converted object in VideoScape ASCII object format.
  247.          If you ommit the filename a file requester will appear, wich has a
  248.          standard assign to RAM:
  249.  
  250.    Displaying:
  251.  
  252.       The object displayed is the triangulated impression of the converted
  253.       object! 
  254.  
  255.       F1            = toggle display on/off  
  256.       F2            = SOLID-WIRE display routine  
  257.       F3            = SOLID display routine
  258.       F4            = WIRE display routine
  259.       F5            = BOX display routine
  260.       F6            = object statistics: number of points,edges,faces in an object
  261.       F7            = object statistics: number of faces with a certain number of edges 
  262.       F8            = MERGE parameters: MAXEDGS, BACKFACE, FACEANGLE, EDGEANGLE
  263.       F9            = decrese rotate angle   
  264.       F10           = increse rotate angle
  265.       SHIFT UP      = rotate backward 
  266.       SHIFT DOWN    = rotate to front
  267.       SHIFT LEFT    = rotate left 
  268.       SHIFT RIGHT   = rotate right
  269.       PHI <angle>   = set horizontal angle        
  270.       THETA <angle> = set vertical angle\n");
  271.       ZERO          = all angles set to 0 degrees\n");
  272.       ABOUT         = info about module       QUIT = exit module\n");
  273.  
  274.    Line editing:
  275.       
  276.       UP            = back in command history
  277.       DOWN          = forward in command history
  278.       LEFT          = cursor left
  279.       RIGHT         = cursor right
  280.       DEL           = delete character
  281.       BACKSPACE     = cursor left + delete character
  282.       
  283.    All prupose:
  284.  
  285.       ABOUT         = info about module and author
  286.       QUIT          = exit module
  287.       HELP          = Help
  288.       HELP key      = Help
  289. -------------------------------------------------------------------------------------------  
  290.